home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / val.z / val
Text File  |  1998-10-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. VVVVAAAALLLL((((1111))))                                                                  VVVVAAAALLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      val - validate SCCS file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      vvvvaaaallll ----
  13.      vvvvaaaallll [----ssss] [----rrrr SID] [----mmmm name] [----yyyy type] files
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _v_a_l determines if the specified _f_i_l_e is an SCCS file meeting the
  17.      characteristics specified by the optional argument list.  Arguments to
  18.      _v_a_l may appear in any order.  The arguments consist of keyletter
  19.      arguments, which begin with a ----, and named files.
  20.  
  21.      _v_a_l has a special argument, ----, which causes reading of the standard input
  22.      until an end-of-file condition is detected.  Each line read is
  23.      independently processed as if it were a command line argument list.
  24.  
  25.      _v_a_l generates diagnostic messages on the standard output for each command
  26.      line and file processed, and also returns a single 8----bit code upon exit
  27.      as described below.
  28.  
  29.      The keyletter arguments are defined as follows.  The effects of any
  30.      keyletter argument apply independently to each named file on the command
  31.      line.
  32.  
  33.      ----ssss          The presence of this argument silences the diagnostic message
  34.                  normally generated on the standard output for any error that
  35.                  is detected while processing each named file on a given
  36.                  command line.
  37.  
  38.      ----rrrr_S_I_D       The argument value _S_I_D (_SCCS _I_Dentification String) is an
  39.                  SCCS delta number.  A check is made to determine if the _S_I_D
  40.                  is ambiguous (e. g., rrrr1 is ambiguous because it physically
  41.                  does not exist but implies 1.1, 1.2, etc., which may exist)
  42.                  or invalid (e. g., rrrr1.0 or rrrr1.1.0 are invalid because neither
  43.                  case can exist as a valid delta number).  If the _S_I_D is valid
  44.                  and not ambiguous, a check is made to determine if it
  45.                  actually exists.
  46.  
  47.      ----mmmmname      The argument value _n_a_m_e is compared with the  s-1SCCS %M%
  48.                  keyword in _f_i_l_e.
  49.  
  50.      ----yyyytype      The argument value _t_y_p_e is compared with the SCCS %Y% keyword
  51.                  in _f_i_l_e.
  52.  
  53.      The 8----bit code returned by _v_a_l is a disjunction of the possible errors,
  54.      i. e., can be interpreted as a bit string where (moving from left to
  55.      right) set bits are interpreted as follows:
  56.  
  57.           bit 0 = missing file argument;
  58.           bit 1 = unknown or duplicate keyletter argument;
  59.           bit 2 = corrupted SCCS file;
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVAAAALLLL((((1111))))                                                                  VVVVAAAALLLL((((1111))))
  71.  
  72.  
  73.  
  74.           bit 3 = cannot open file or file not SCCS;
  75.           bit 4 = _S_I_D is invalid or ambiguous;
  76.           bit 5 = _S_I_D does not exist;
  77.           bit 6 = %Y%, ----yyyy mismatch;
  78.           bit 7 = %M%, ----mmmm mismatch;
  79.  
  80.      Note that _v_a_l can process two or more files on a given command line and
  81.      in turn can process multiple command lines (when reading the standard
  82.      input).  In these cases an aggregate code is returned - a logical OOOORRRR of
  83.      the codes generated for each command line and file processed.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      admin(1), delta(1), get(1), help(1), prs(1)
  87.  
  88. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  89.      Use _h_e_l_p(1) for explanations.
  90.  
  91. BBBBUUUUGGGGSSSS
  92.      _v_a_l can process up to 50 files on a single command line.  Any number
  93.      above 50 will produce a ccccoooorrrreeee dump.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.